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2330222 

BI-DIRECTIONAL CONVERSION LIBRARY 



FIELD OF THE INVENTION 

This invention relates in general to a method for translating data structures used by a 
computer program written in a first computer programming language to its equivalent 
in a second computer programming language and more specifically for translating 
between the data structures of ,the>two computer programming languages Java™ and 

c. • ■■■ - 

BACKGROUND OF THE INVENTION 

In present day multi-platform computing environments, it is often a requirement that 
programs written in one language have to interact with programs written in another 
language (e.g. a computer program from Java™ making use of a C library). A prime 
difficulty with the interaction of programs written in different computer programming 
languages is the representation of data - each language stores information differently. 
If two programs are to interact, one program must convert the data from the 
representation used by the other program to its own. 

The Java™ Native Interface "(JNI) Application Prograinming Interface (API) is 
provided in the Java™ programming language to call C functions as if they were 
written in Java™. The Java™ Interface also provides* set of functions for 

converting primitive data types. While this is an elegant solution from a Java™ code 
perspective, it results in an interface which is extremely difficult" to understand and to 
use from a C code perspective. It is well known in the art that typical computer 
programs use complex data structures built from the primitive data types. The JNI 
does not provide a method for automating the conversion of complex data structures. 
Also, complexity of this interface practically ensures that faults will find their way 
into applications where native methods are used. The danger presented by these faults 
is extreme since the native method interface allows C functions to access pointers to 
memory residing inside a Java™ virtual machine (VM). 
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The Java™ VM is intended to present an abstract, logical machine design free from 
the distraction of inconsequential details of any implementation: The memory areas 
of the Java™ virtual machine do not presuppose any particular locations in memory or 
locations with respect to one another. The memory areas need not consist of 
5 contiguous memory. However, the instruction set, registers, and memory areas are 
required to represent values of certain minimum logical widths (e.g. the Java™ stack 
is 32 bits wide). These requirements are discussed in the following sections. 

The Java™ virtual machine is a machine which runs a special set o f instructions 
10 which specify every possible instruction which may be implemented by the machine. 
The Java™ VM allows ever computer to run Java™ applications. A pointer is a data 
item which specifies a location of another data item. Pointers are very unstable and 
; therefore their use can lead to unstable computer operations, which can lead to a 
possible crash of the entire Java™ VM. 

To reduce the complexity of implementing native methods,- and to minimize the 
number of places where pointers to memory within the Java™ VM are accessed, the 
inventors have recognized the desirability of providing a means to convert objects (or 
even primitive data types) used in legacy function calls (i.e. function calls provided by 
20 existing programs). In software, a legacy system is an existing system to which new 
code is being added and a legacy function is a function used in such a system. By 
localizing this conversion to a single Ideation, much of the danger inherent in the use 
of native methods Can be mitigated/ 

25 SUMMARY OF THE INVENTION '' 

According to the present invention, a bi-directional conversion library is provided 
which translates and converts data structures used in a first programming language to 
equivalent data structures of a second prograniming language, and vice versa. In the 
30 preferred embodiment, using Java™ and C as the first and second programming 

languages, respectively , the library of the present invention utilizes the Java™ Native 
Interface (JNT). The JN1 is the interface between Java™ and any other computer 
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programming language which is to be incorporated into Java™ applications during 
the conversion process. At the present time, only C and C++ are supported by the 
Java™ Native Interface. The bi-directional conversion library of the preferred 
embodiment may be implemented. as an API provided by a Dynamic Link Library 
(DLL) for allowing Java™ data objects to access C functions via a mapping layer. 
Each DLL function takes a pointer to the JNI ; as a first parameter. By limiting the 
of this j>ointer ; tp a.select set of functions,, the-problem inherent in the prior art-Java™ 
Native Interface API of allowing C functions to access pointers to memory residing 
inside the Java - ™ VM is eliminated. . 

BRIEF DESCRIPTION OF THE DRAWINGS 



use 



A preferred embodiment of the invention is described below with reference to the sole 
drawing, in which: ••<•,. 
15 ' *. 

Figure 1 is a. schematic illustration showing the process architecture for layered 
interaction between Java™, servers and legacy C code according to the preferred - 
embodiment. 

v ■ .»' .- .. • • 

j ... .j ■ . 

20 DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENTS 

Figure 1 shows a preferred ? ,architecture for a.Jaya™-to-C Conversion system 10- In 
this architecture, Java™ data objects 12 access legacy C functions 14 via a 
mapping layer 16. This layer 16 uses a bi-directional Java™-to-C conversion library 
18 to convert Java™ data objects 12 into equivalent C structures 20 and calls an 
unmodified legacy C function 14. Each legacy API 14 requires an associated 
mapping layer 16, since mapping for each function may be different (e.g.. a single 
Java™ data object 12 may map into multiple parameters in the function signature). 
The conversion library 18 provides a suite of functions to provide a consistent, well- 
defined approach to implementing the mapping layer 16. Also although the disclosure 
hereinafter describes mainly the. conversion from Java™ to C in detail, it will be 
understood by a person skilled in the art how to convert data structures from C to 
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Java™, or with appropriate substitutions of functions, convert between two other 
different computer prograrnrning languages. 

In the following description of Figure 1. a conversion from Java™ to C is disclosed 
using the preferred embodiment of the present invention. We will use a Java™ data 
object within App 1 12 as our focus for this description: The first action is that a 
method of the Java™ object App 1 12 is called by another Java™ process. After 
being called, depending on the call, it calls a method provided by its correspondmg 
App 1 API class 22 or accesses a Database API class 24. After the- App 1 API class 
22 or the Database API Class 24 has been accessed; the mappifig or Native C layer 16 
is accessed through a corresponding Native Method Interface, the APP 1 Native 
Method Interface 20 arid a Database Native Method Interface 26 respectively. This 
means that the APP 1 API Class 22 Calls the APP I Native Method Interface 20 and 
the Database API class 24 calls' the Database Native Method Interface 26. The 
mapping layer 16 will take any Java™ data submitted from the calls from the API 
layer 22 located inside the middle layer arid" translate the Java™ data 12 into an 
equivalent C data structure. After transiting the Java™ objects into equivalent C 
data structures, the Native Method Interface calls a corresponding legacy App 1 API 
14 For the Database Native Method interface 26,' a call is "made to a legacy Database 
view layer (DBView). If the legacy App 1 API 14 has been chosen, then it must 
access the legacy DBView API 28 since me legacy App 1 API requires the Database 

30. ' ' " '[ ' ' ' " " ' 1 _ '" ." " " " 

The conversion library 18 is an API provided DLL located within the Native C 
25 mapping layer 16 for linking a Java™ application to a C application by perfornung 
the necessary actions to translate Java™ data objects 12 to C data structures 14 and 
the complementary: actions to translate C data structures 14 to Java™ data objects 12. 

As discussed in greater detail below, the DLL implementing the conversion library 18 
comprises four mam groups of functions as follows: string functions, array functions, 
object/structure functions and field accessor/mutator functions. An accesor is a 
method or function mat returns the value of encapsulated data while a mutator 
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performs a complementary action setting a value of encapsulated data. It should be 
noted that every DLL function of the conversion library 18 takes a pointer to the 
Java™ Native Interface environment as a first parameter. A pointer is a data item 
which specifies the location of another dataitem. Limiting the use of this pointer to 
the conversion library, instead of allowing native methods to access the memory of 
the Java 1 ** VM directly -decreases the chance of crashing the Java™ VM , is discussed 
briefly above. 

The group of string functions provides ,njeanSi for converting between Java™ String 
objects and anull terminated array of char representation used in C. Six functions are 
provided: createJavaString, createaavaStringFromWide, 
allocCString, freeCString, allocCWideString, and 
f reeCWideS.t r Ing It should be noted that the names of these functions and of 
the ones set/forth belpw may be changed, and still perform the same function provided 
that the changes are made globally (i.e. throughout the program). The names used in 
computer programs are mainly for the benefit of the programmer as a reminder of 
what each separate function or procedure ,dpes. Using the string functions as an 
example, the first function create JavaString is named so as to clearly indicate 
that it creates a Java 1 ? 1 String. Thus for example, if all of the occurrences of the 
phrase name createJavaString in the.program were changed to 
nothingcreated, ^a call of the.nothingc^eated function would still 
perform the original function of creating a Java™ String object. Therefore, the 
conversion library is not dependent on the name of the functions and the choice of 
names isalso notrestricted. r « 

' ' • - « . , ' t 

The createJavaString function creates a. new Java™ string object based on a C 
string passed as a parameter. A parameter is information located in another part of the 
computer program which is needed in order to run the calling function. In this case, 
the parameter is the C string which is to be translated to Java™ by the conversion 
library of the present invention. The Java™ string need not be freed, since Java's™ 
garbage collection is responsible for r managing the. memory allocated for the string 
object. Freeing of a string returns memory back to the computer allowing it to be 
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reused later. Java's™ garbage collection automatically determines when memory is 
no longer needed and frees the memory for later use. A representative API for the 
create JavaSt ring function is as follows: 

5 j string createJavaString ( 

... ■*'.•(. ...» '. . 

JNIEnv * env, 
const char * cString); 

The create JavaS t ringFromWide function creates a new Java™. string based 
io on a wide C string passed as a parameter (i.e. a nulUterminated array of unsigned 
short). This function is performed in a similar manner to the previously discussed 
createJavaString function and may be implemented by the following API: 

j string cr eate JavaS tringFromWide ( 

15 JNIEnv * env, 

const unsigned short * cString ) ; 

The allocCSt ring function creates a new C string based on a passed Java™ string 
object, and is the complement to the createJavaString function. The returned 
20 string is declared to be a constant (const; since the string is allocated within the 
Java™ VM and therefore should not be modified. This is also consistent with the 
treatment of strings within Java™ where a Java™ string object is immutable. A 
representative API 'for allocatingds as-.follows: , . > ,. v 

const char *, allocCString ( . 



30 



JNIEnv * env, 
j.string javaStr ) ; 



Since there is no garbage collection in C, all strings created with allocCString 
must be freed via a call to f reeCString, which may be implemented by the 
following API: 



void f reeCString ( 
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JNIEnv * env, - 

j string javaStr, ^ 

const char ** stringToFree ) ; 

/* Note: 'pointer to a string */ 

The allocCWideString and f reeCWideString functions perform analogous 
operations for wide C strings. The f reeCString function takes a pointer to a 
string allocated via allocCString (const char **) as a parameter, not simply a 
string (const char- This use of the pointer ensures that the freed string is not 
referenced a later timei Representative APIs for allocCWideString and 
f reeCWideString are as. follows: 

const unsigned, short * allocCWideString ( 
JNIEnv * env, 
j string javaStr ); 

void f reeCWideString ( 

JNIEnv : * env, 
j string javaStr, 

const unsigned short '** stringToFree '' ) ; "'• 

/♦ ■ Note : pointer to, a string */ 
' ' ■■ • ; . ■■ ■ ■ • ■ . , ■ , ■ 

The array factions provide means' for cbnverting between Java 7 ** 1 arrays and their C 
counterparts where both arrays of primitive data types and of objects are supported. 
Primitive data types are defined as data elements built-in to the computer language 
which represent a single piece of data (eg. a number) Examples of primitive data 
types include integers, float, and boolean. For the purposes of thes6 functions, Java™ 
string objects are considered primitive data types, since a class description is not 
needed. Five functions are provided: createJavaPrimitiveArray, 
createJavaObjectArray, allocCPrimitiveArray , 
allocCStructureArray and f reeCArrayV 

The create JavaPrimitiveArray and create JavaObj ectArray functions 
both create a Java™ array based on a C array passed in as a parameter. In each case, a 
size and type of the array must also be specified. In the case of creating an object 
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array, a class descriptor for an associated class must also be provided. In a similar 
manner to Java™ string objects, Java™ arrays need not be freed, as they are garbage 
collected by the Java™ programming language. Representative APIs for this function 
are as follows: 

j array createJavaPrimitiveArray ( 

JNIEnv * env 

char * arrayType, • ' ; • 

,.*' void * cArray, ..lc >.:<-. .-o.ls 

10 int cArrayLen ) 

j array createJavaOb j ectArray ( 

JNIEnv * env T 
void * cArray, 
15 int cArrayLen, . : - ; ; 

classDesc_t * classDesc ) ; _ 

The allocCPrimitiveArray and al 1 ocCS true tureArray functions both 
create a C array based on a Java™ array passed as a parameter. The returned array is 

20 a copy of the associated Java™ array so that any changes made to this, new C array 
are not reflected in the original Java™ array. For both functions, the type of array 
must be specified. In contrast to the Java™ array creation functions, the C array 
creation functions return the length of the allocated array via a numElements 
.parameter. The aXlocCStruqt.urpArray function alsoTequires the class , 

25 descriptor describing the Java™* array elements passed as a parameter. Exemplary 
APIs for allocCPrimitiveArray and allocCSt rue tureArray are as 
follows: 

void * allocCPrimitiveArray ( 

30 JNIEnv * env 

j array javaArray, 

char * ar rayType , . m . ■ 

int * numElements ) ; 
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void * allocCStrucutreArray ( 
JNIEnv * env, 
j array javaArray, 
char * arrayType, 
5 classDesc_t * classDesc, 
int * numElements ) ; 

As is also the case with the string functions, since C does not provide garbage 
collection, the f reeCArray function must be called to release memory associated 
10 with the allocated C array. The f reeCArray function may be implemented by the 
following API: - 

void freeCArray{ 

JNIEnv * env, *- ; 
15 j array javaArray, 1 
char * arrayType, 

~ r » * 

void ** CArray ); -* 

The object/structure functions are at the core of the Bi-Directional Conversion Library 
20 according tot he present invention. TTieSe functions are used to convert between 
Java™ objects andC structures. Four object/structure functions are provided: 
java2c, c2java, createEmptyJavabbject, and 
createJavaObjectFromStruct.' 

25 The j ava'2 c function fills a specified C f sthictiire with '"data contained in a Java™ 
object passed to the function according to ah fodiciteici class descriptor. An API for 
implementing the j ava2c function is ^follows: 

void java2c( 
30 JNIEnv * env 

j object javaObj, 
void * cStruct 
classDesc_t * classDesc ) ; 
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The c2 j ava function performs the complementary action of copying the data within 
a C structure to a corresponding Java™ ob ject according to an indicated class 
descriptor. A representative API for c2java is as follows: 

void c2java( 
jNIEnv * env, 

jobject javaObj . . . . , . . ■ . - . 

void * cStruct, 
classDesc_t * classDesc ); 

It should be noted that the j ava2c and c2 j ava factions of the preferred 
embodiment do not provide any facilities for converting static data members of a 
Java™ object. 



l5 The design of class descriptors is set forth herein below for use with the j ava2c and 
c2java functions of the conversion library according ;to the invention: The 
following description is predicated on ih^^P^ ^ ^Y^^ 
exist, and that data in these structures is required in the Java™ programs. or objects to 
be converted. The following steps illustrate the process of creating a Java™ class to 

20 parallel a C structure and describing the ^^ J^a^ class via a class descriptor. - 

1) Identify the required C data structure (at -tfie time of its creation; the library of the 
present invention assumes mat legacy exist - otherwise, C and 
Java™ structures can be developed in tandem, as would be understood by a person of 

25 ordinary skill in the art). 

2) Create a Java™ class with data members in a one-to-one correspondence with the C 
data structure identified in step 1 (even though this may not result in the best object- 
oriented design). This class must have a public default constructor defined. The 

30 default constructor is a constructor for a Java™ object which does not take in any 

parameters. It should also be noted that data members must not be class variables (i.e. 
not static data members). Any access specifiers can be used for data members (e.g. 
they can be private, protected or public). 
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3) Define an array of field descriptors, with one entry per data member of the Java™ 
class created in Step 2. The following is a brief description of the information which 
must be defined: 

5 

• fieldName: name of a data member in the Java™ class 

• f ieldType: one of JTYPE_* as defined in jaya2c . h, { discussed in greater 
detail below 

• fieldoffsetran offset into the C structure of the associated field (use an 
10 "of fisefpf "4nacn> prpyided by Microsoft's™ C compiler) 

• I maxElems: 

if f ieldType is JTYPE_STRING or JTYPE_WSTRING, this is the 
maximum string length in characters 

if f ieldType is j;txp.E_ARRA;y or, JTYP.E_yARRAY, this is the maximum 
15 number of elements in 'the array; T r ..... 

• arraySizeOf f 3et: ifjf ieldType.is *^TYPE_VA3FIRAY, this is the offset the 
field in the C structure which contains the actual number of elements in the array. 
This allows an array with a certain maxElems to be occupied by fewer elements, 
as specified , in another field of the structure 

20 • f ieldClassDesc - if f ieldType is JTYPEJDBJECT ( className 
-) / JTYPE_ARRAY ;( JTYP^_pB JEqT. X className ) ) , or 
JTYPE ,V ARRAY. .( . . JTYPE OBJECT ( className j ) , this is a 
. . pointer to the class for.c las sName 

25 4) Define a class descriptor with the following information: 

• className: the fully qualified Java™ class name using V as a class delimiter 
... e.g. "ops/dbview/myDbclass" 

• numf i e 1 ds : the number of fields in the field descriptor array 

• size: the size of the assoicated 'C 9 structure (use the "si zeof" macro). 
30 • fields: the array of field descriptors from 3) 
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An actual example of the steps involved in creating the Java™ class to parallel a 
following hypothetical C structure ptherStruct_t and its corresponding 
otherClass is disclosed herein below: 
typedef struct { 

char sorneString [ MAX_STRJLEN : * 1 J ; , 
int numValues; 

otherStruct_t values [ MAXJVALUES ] ; 
} . inf o_ t ; 

■ •■ . » ^ ■**.•'. 

The following Java™ class could be created (other methods cap be added - only the 

data members matter for this library): 



public class Info { 

private "■ String sorneString = null^ 
l5 private int numValues = 0; 

private otherClass [ 3 values = 

new otherClass [ MAX_VALUES lr ' 

public InfoO 

20 { - . , lV , - . i . ' • V: 

// create otherClass objects in values array 

}; \ ' " ' ' 7' 

} 

25 The following exemplary fieldDesc_t (field descriptor array) and 
classDesc_t (class descriptor array); definitions are defined: 

fieldDesc_t infoFields [ ] = { ; 
{ "sorneString", 
30 JTYPE__STRING, ' 

offsetof ( . inf o_t, . sorneString ) , 

. . . MAX_STR_LEN .* 1, . . 

0 . f // not applicable for this field type 

NULL }, // not applicable for this field type 
35 { "numValues", 

JTYPE INT, 



=? — 
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offset ( info_t, numValues ), 

0, // not applicable for this field type 

0, If not applicable for this field type 

NULL }, // not applicable for this field type 
{ "values", 

JTYPE_VARRAY { JTYPE_OBJECT ( * "otherClass" ) 



) , 



}; 



bffsetof" ( info_t'/ values ) \ 
MAX_VALUES , 

10 of f setof ( inf o_t , numvalues ) , 

icikssbe^ForOtHereiass- » < . 

classDesc_t inf oClassDesc = { 
"Info", 

sizeaf .^ A i-nf of ields \ / sizeof ( fieldDesc_t 
), // num fields . i. 

sizeof. .( . . inf or_t ) , . : 
inf oFields. u .*} ; : , 

20 The createEmptyJavaObj ect function creates a new Java™ object of a 

specified class in a className parameter based on a default constructor. The data 
members of a newly created object are not assigned any values unless a default 
constructor performs initialization. A representative API for this function is as 
follows: 

25 ;; >:*l .W.V.. r : f % / ./ Jv.^v:.* ... • 

j object cr^ateQnptyJavaObject. ( — r> . 

JNIEnv * env 

char * className )-; : - 

30 The creat e JavaOb j ectFromStruct function creates a new Java™ object 

based on a specified class descriptor. The data members of the new Java™ object are 
initialized with the values contained in a C structure passed in as a cStruct 
parameter. The create JavaOb j ect FromSt met function may be implemented 
by the following API: 

35 
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jobject createJavaObj ctFromStruct ( 

jNIEnv * env, 
void * cStruct, 
classDesc_t * classDesc ); 



25 



It should be noted that both of the createEmpty^JavaOb j ect and 
createJavaObj ectFromStruct functions each create a Java™ object using a 
default constructor. The default constructor must be defined for all objects to be 
created via the conversion library DLL of the present , invention. If a constructor other 
than the default constructor is required, the JNI NewOb j ect function must be 
chosen. 

Often, not all of the data members of an object passedto a native method are required. 
The field accessor/mutator functions discussed belpw ; allow, individual fields of an 
object to be read (via an accessbr.function) or modified (via a mutator function). 
None of these functions require, a class descriptor Jo be defined, It should be noted 
that field accessor/mutator functions do not provideany facilities for accessing or 
changing static data members of a Java™ object. 

Two sets of accessor/mutator pairs are provided in accordance with the preferred 
embodiment: get<Primitve • Type^e^-d/ ,set<Primitive ; . .. 
Type >Field and getObjectField/setObj ect Field. 



The get<Primitive Type>Field/set< Primitive Type>Fieldpair of 
functions provide means to access and modify primitive data members of a Java™ 
object based on their names. Each primitive type has its own pair of accessor/mutator 
functions, each of which returns a value of the appropriate C type. The supported 
types are summarized below: 

Field Type Primitive Type> Return/Parameter Type 

in Function Name 
JTYPE INT Int int 
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JTYPE_LONG 




_int64 


JTYPE_SHORT 


Short 


short 


JTYPEBYTE 


Byte 


char 


JTYPE_WCHAR 


Wchar 


unsigned short 


JTYPE_CHAR " 


Char 


unsigned char 


jtype_floAt 


• Float 


float 


TTVP*P TlfM tot f 1 


LsUUUl tr 


double • 


jtyi*e_b6olean 


Boolean s 


boolean, 


TlTPE_StRING 




jstring 









The string type is a special case, since in Java™ it is a class, where as in C it is a 
primitive array. ' The 'bidirectional conversion library of the present invention treats 
5 the string as a priihitiVe type (since a class descriptor is not required), but the Java"^ 
string value retted cknhot be used directly by theGcode. Thecal locCString 
and'f reeCSl: ring fiinctioi&'muSt'be usfid to allocate and free C-style strings. It 
should be notecfillat primitive data typfes are basic field types such as boolean , integer 
or byte. ' - " * 

10 

The get< Primitive Type>Fi : eld/set<Primi£ive Type>Field .„ 
functions may be iihplem6nted by the folfo 

<Native Type> get <Primtive Type>Field( 

15 JNIEnv- : * - ehvv • " % - s- : . 

j object jvavaObj -<, v . : . . ; . i% : .. 

ohar * fieldName. ) ,\ 

void set<Primitve Type>Fiel<i( 

20 JNIEnv * env, 

j ob j e c t j a vaOb j , 
char * fieldName, 
<Native Type> value); 
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The getob j ectField and setOb j ectField functions allow embedded objects 
to be accessed and modified. ' In addition to a field name in the Java™ object, the type 
of the object must also' be specified. A JTYPEJDBJECT (className) macro can 
'be used to formulate the type specifier. A skilled person will recognize that care 

5 should be taken when using the object accessor/mutator functions since the 

getob j ectField function returns a reference to an actual embedded object, and 
1 not a copy of the object. The setobj ectField replaces the reference to an 
existing embedded object with a reference to the new copied object. Typical usage of 
these functions would include using the getobj ectField to retrieve a reference to 

10 an object, and then to use the j ava2 c , c2 j ava or a field accessor/mutator pair to 
manipulate the data. Since a reference to an original object is used, the 
setobj ectField function need not be called (since it would merely change the 
reference back to the same object). If a new object is created via the 
createEmptyJavaObject or createJavaOb j ectFromStruct functions, 

15 the setobj ectField function should be used to replace the existing embedded 
object with the new object. Exemplary APIs for the getob j ectField and 
setobj ectField functions are as follows: 

j object ge tObj ectField ( 

20 JNI Env * env , 

j object javaObj, 
char * fieldName, 
char * f ieldType ) ; 

25 void setobj ectField ( 

JNI Env * env, 

j ob j ect j avaOb j , 

char * fieldName, 

char * fieldType, 
30 j object value ) ; 

It will be appreciated that, although one particular embodiment of the invention has 
been described in detail, various changes and modifications may be made. For 
example, in the mapping layer, the conversion functions could be directly integrated 
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into legacy C code. Also, although not provided by the implementation set forth 
herein, the mapping of primitive data types may.bq included in the conversion. 
Although the preferred embodiment provides for embedded objects to be embedded 
within themselves alternative embodiments are contemplated which do not support 
5 embedded objects or reference them to external structures. With respect to the 

mapping of arrays, embodiments are possible which do not to provide array mapping 
functions or array accessor/mutator functions. It is contemplated that access may be 
provided to Java™ Obj ect Methods, as would be understood by a person of ordinary 
skill in the art. 'Furthennore, although the detailed description of the preferred 
10 embodiment herein above^is limited to a discussion of the conversion between Java™ 
and C, it will be appreciated that conversions are possible between any two different 
computer languages according to the principles of the present invention, and in 
particular C can' be converted mto Java™. All such changes and modifications may be 
made without departing from the sphere and scope of the invention as denned by the 
15 claims appended hereto. 
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, A bi-directional conversion library for converting data armories from a first 
programming language into data structures of a second programming language, 
comprising: 

a) a plurality of string functions for creating new string objects to said firs, and 
second programming languages based on stiing parameter passed thereto from sa,d 
second and first programming languages, respectively; 

: b) a plurality of array Sanctions for creating new array objects in said firs, and 
second progrumming languages based on armyparamererspasseduterao from sard 

second and first programming languages, respectively; • ' 

c) a plurality of object/structure functions for copying dau> between an object 
: of said firs, programming language and a dau structure of said second programmmg 
15 ianguage according ,0 predetermined indicated class descriptors atid for creartng new 
objects in said firs, pmgramming language based on one of either a default 
constructor or a specified da* structure of me secdnd pmgmmming language 
' according ,0 a specified ci'ass descriptor; and 

d) a plurality of field accessor/mmamr functions for reading and modifying 
individual fields of an objec, in said firs, and second programming languages. 



20 



•>-,v.x 



2 The bi-directional conversion library of claim 1, wherein said firs, 
programming language is Java™ and said second pmgramming language ts C, and 



25 wherein 



in Java™ includes a Java™ Native Interface (JNI)' facility. 



3 The bi-directional conversion library of claim 2, wherein each of said 
actions takes apointer to said Java™ Native Interface (JNI) environment as a first 

parameter. 



30 
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4. • The bi-directional conversion library of claim 3, wherein one of said string 
functions creates a new Java™ string object based on a C string passed to said 
function as a parameter. 

5. . • r A The bi-directional conversion library of claim 3, wherein one of said string 
functions creates a new Java™,string object based on a wide C string passed to said 
function as a parameter. 

6.. Theterdirection^ pf claim 3, wherein one of said string 

functions pt&t^ftflgff gj^fybte^jqn a Java™ string object passed to said 
function as a parameter. 

7. The bidirectional copyersipn library of claim 3, wherein one of said string 
functions creates a new wide Cstring based pjn a. Java™ string object passed to said 
function as a parameter. f ..... r 



8. The bi-directional conversion library. of claim 6 or 7, wherein one of said 
string functions frees said new C string for .releasing memory allocated for said new C 
string. 



9. The bi-dire,ctionaI .cpnyCTsipn a Ub^ r of claim 3, wherein one of said array 
functions creates a new Java™ array based on a C array passed to said function as a 
parameter. ; , . . .. • 

1 0. The bi-dkectionai conversion library of claim 3, wherein one of said array 
functions creates a new C array based on a Java™ array passed to said function as a 
parameter. ... 

1 1 . The bi-directional conversion library of claim 1 0, wherein one of said array 
functions frees said new C array for releasing memory allocated for said new C array. 
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12 The bi-directional conversion library of claim 3, wherein one of said 
object/structure functions fills a predetermined C structure with data contained in a 
Java™ object passed to said function according to a predetermined one of said 
indicated class descriptors. 

13 The bi-directional conversion library of claim 3, wherein one of said 
object/structure functions copies data within a predetermined C structure to a * 
corresponding Java™ object according to a predetermined one of said indicated class 
descriptors. 

14 The bi-directional conversion library of claim- 3, wherein one of said 
object/structure functions creates a new Java™ object of a specified class in a 
className parameter based on a default constructor. 



20 



15 The bi-directional conversion library of claim 3, wherein one of said 
object/structure functions creates a new Java™ object based on a specifiedC data 
structure according to a specified class descriptor. 

16 The bi-directional conversion library of claim 3, wherein one pair of said field 
accessor/mutator functions provides access to and modification of primitive data 
members of a Java™ object based on names of said data members. - 

17 The bi-directional conversion library of claim 3, wherein one pair of said field 
accessor/mutator functions provides access to and modification of embedded Java™ 

25 objects. 

18 An Application Programming Interface (API) comprising the bi-directional 
conversion library of claim 1 implemented as a Dynamic Library Link (DLL) for 
Unking a first application written in said first object-oriented language with a second 

30 application written in said secorid object-oriented language. 
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